Add some missing nullable return annotations

diff --git a/gdk/gdkclipboard.c b/gdk/gdkclipboard.c
index b408a68e23368c150493ce805961d593ff1cdef2..8ed2acef6b9d10f09f3e7f955563dd67d73ae50e 100644 (file)
--- a/gdk/gdkclipboard.c
+++ b/gdk/gdkclipboard.c
@@ -681,7 +681,7 @@ gdk_clipboard_read_async (GdkClipboard        *clipboard,
  *
  * Finishes an asynchronous clipboard read started with gdk_clipboard_read_async().
  *
- * Returns: (transfer full): a #GInputStream or %NULL on error.
+ * Returns: (transfer full) (nullable): a #GInputStream or %NULL on error.
  **/
 GInputStream *
 gdk_clipboard_read_finish (GdkClipboard  *clipboard,

diff --git a/gdk/gdkcontentformats.c b/gdk/gdkcontentformats.c
index e677e68808ead24a3267260144f1b41ec585a198..005d387b7c5315a2bf477040725834fd9efc5683 100644 (file)
--- a/gdk/gdkcontentformats.c
+++ b/gdk/gdkcontentformats.c
@@ -385,7 +385,7 @@ gdk_content_formats_match_gtype (const GdkContentFormats *first,
  * in @second. If no matching mime type is found, %NULL is
  * returned.
  *
- * Returns: The first common mime type or %NULL if none.
+ * Returns: (nullable): The first common mime type or %NULL if none.
  **/
 const char *
 gdk_content_formats_match_mime_type (const GdkContentFormats *first,

diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index 8fccd2a5211cc0c08c92ceed405285d3e4d526fc..9942ec6063255d1cdd30156cfb947088aca80a6e 100644 (file)
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -1107,7 +1107,7 @@ gdk_display_notify_startup_complete (GdkDisplay  *display,
  * Gets the startup notification ID for a Wayland display, or %NULL
  * if no ID has been defined.
  *
- * Returns: the startup notification ID for @display, or %NULL
+ * Returns: (nullable): the startup notification ID for @display, or %NULL
  */
 const char *
 gdk_display_get_startup_notification_id (GdkDisplay *display)

diff --git a/gdk/wayland/gdkdisplay-wayland.c b/gdk/wayland/gdkdisplay-wayland.c
index c37ce3d4d03a78d90871b17ee8d57048da0c2fd6..1c49b1337149329bbce6c4a03f98141b1176da66 100644 (file)
--- a/gdk/wayland/gdkdisplay-wayland.c
+++ b/gdk/wayland/gdkdisplay-wayland.c
@@ -873,7 +873,7 @@ gdk_wayland_display_get_next_serial (GdkDisplay *display)
  * Gets the startup notification ID for a Wayland display, or %NULL
  * if no ID has been defined.
  *
- * Returns: the startup notification ID for @display, or %NULL
+ * Returns: (nullable): the startup notification ID for @display, or %NULL
  */
 const char *
 gdk_wayland_display_get_startup_notification_id (GdkDisplay  *display)

diff --git a/gsk/gsktransform.c b/gsk/gsktransform.c
index 7f9cc20e5b83e89a536a0f097d2abfce16dd6478..adc64ccc30f75eb7e46354a8a2452b6647c97900 100644 (file)
--- a/gsk/gsktransform.c
+++ b/gsk/gsktransform.c
@@ -1684,7 +1684,7 @@ gsk_transform_transform (GskTransform *next,
  * between those cases, you should check @self is not %NULL
  * before calling this function.
  *
- * Returns: The inverted transform or %NULL if the transform
+ * Returns: (nullable): The inverted transform or %NULL if the transform
  *     cannot be inverted.
  **/
 GskTransform *

diff --git a/gtk/gtkbuilderparser.c b/gtk/gtkbuilderparser.c
index 3ea04b941f0303caba7ca9aba36e375cac8b9840..66ff6981a73c55006e20fad89f6437cd3405488e 100644 (file)
--- a/gtk/gtkbuilderparser.c
+++ b/gtk/gtkbuilderparser.c
@@ -296,7 +296,7 @@ gtk_buildable_parse_context_pop (GtkBuildableParseContext *context)
  * give the element_name as passed to those functions. For the parent
  * elements, see gtk_buildable_parse_context_get_element_stack().
  *
- * Returns: the name of the currently open element, or %NULL
+ * Returns: (nullable): the name of the currently open element, or %NULL
  */
 const char *
 gtk_buildable_parse_context_get_element (GtkBuildableParseContext *context)

diff --git a/gtk/gtkentrycompletion.c b/gtk/gtkentrycompletion.c
index 8f3ee30eda20f7225d151dc398181cb5465c2fd1..6c197a45720682901a287cab4497a90547f2ccec 100644 (file)
--- a/gtk/gtkentrycompletion.c
+++ b/gtk/gtkentrycompletion.c
@@ -1329,7 +1329,7 @@ gtk_entry_completion_real_insert_prefix (GtkEntryCompletion *completion,
  * Get the original text entered by the user that triggered
  * the completion or %NULL if there’s no completion ongoing.
  *
- * Returns: the prefix for the current completion
+ * Returns: (nullable): the prefix for the current completion
  */
 const char *
 gtk_entry_completion_get_completion_prefix (GtkEntryCompletion *completion)

diff --git a/gtk/gtkexpression.c b/gtk/gtkexpression.c
index 009c2da8c7ed28f5d438f2ed2b9ab42eee64f41c..f7c25f9c7350e03febd4161f79be6c3ac99c82c4 100644 (file)
--- a/gtk/gtkexpression.c
+++ b/gtk/gtkexpression.c
@@ -1026,7 +1026,7 @@ gtk_object_expression_new (GObject *object)
  *
  * Gets the object that the expression evaluates to.
  *
- * Returns: (transfer none): the object, or %NULL
+ * Returns: (transfer none) (nullable): the object, or %NULL
  */
 GObject *
 gtk_object_expression_get_object (GtkExpression *expression)

diff --git a/gtk/gtkstyleproperty.c b/gtk/gtkstyleproperty.c
index e6fee266f06d910c0cf893158ed9f585f8472343..964ac388ed07ddbf54a9dda54101b1ad8555b0f2 100644 (file)
--- a/gtk/gtkstyleproperty.c
+++ b/gtk/gtkstyleproperty.c
@@ -128,7 +128,7 @@ _gtk_style_property_init (GtkStyleProperty *property)
  * always be a #GtkCssValue whose values can be queried with
  * _gtk_css_array_value_get_nth().
  *
- * Returns: %NULL on failure or the parsed #GtkCssValue
+ * Returns: (nullable): %NULL on failure or the parsed #GtkCssValue
  **/
 GtkCssValue *
 _gtk_style_property_parse_value (GtkStyleProperty *property,

diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index b56bff2ef5aa13f962041d36706459be0de702bd..377a365d7b1ed209fba1bab4a702152440963a07 100644 (file)
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -623,7 +623,7 @@ gtk_tree_path_new (void)
  * child of that 11th child, and the 1st child of that 5th child.
  * If an invalid path string is passed in, %NULL is returned.
  *
- * Returns: A newly-created #GtkTreePath-struct, or %NULL
+ * Returns: (nullable): A newly-created #GtkTreePath-struct, or %NULL
  */
 GtkTreePath *
 gtk_tree_path_new_from_string (const char *path)
@@ -866,7 +866,7 @@ gtk_tree_path_get_depth (GtkTreePath *path)
  *
  * The length of the array can be obtained with gtk_tree_path_get_depth().
  *
- * Returns: The current indices, or %NULL
+ * Returns: (nullable): The current indices, or %NULL
  */
 int *
 gtk_tree_path_get_indices (GtkTreePath *path)
@@ -2286,7 +2286,7 @@ gtk_tree_row_reference_unref_path (GtkTreePath  *path,
  * propagated, and the path is updated appropriately. If
  * @path isn’t a valid path in @model, then %NULL is returned.
  *
- * Returns: a newly allocated #GtkTreeRowReference, or %NULL
+ * Returns: (nullable): a newly allocated #GtkTreeRowReference, or %NULL
  */
 GtkTreeRowReference *
 gtk_tree_row_reference_new (GtkTreeModel *model,
@@ -2333,7 +2333,7 @@ gtk_tree_row_reference_new (GtkTreeModel *model,
  * need to carefully monitor exactly when a row reference updates
  * itself, and is not generally needed by most applications.
  *
- * Returns: a newly allocated #GtkTreeRowReference, or %NULL
+ * Returns: (nullable): a newly allocated #GtkTreeRowReference, or %NULL
  */
 GtkTreeRowReference *
 gtk_tree_row_reference_new_proxy (GObject      *proxy,